home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / editors / emacs / xemacs / xemacs-1.006 / xemacs-1 / lib / xemacs-19.13 / info / gnus.info-1 < prev    next >
Encoding:
GNU Info File  |  1995-09-01  |  48.9 KB  |  1,252 lines
  1. This is Info file ../info/gnus.info, produced by Makeinfo-1.55 from the
  2. input file gnus.texinfo.
  3.  
  4.    This file documents GNUS, the GNU Emacs newsreader.
  5.  
  6.    Copyright (C) 1989 Fujitsu Laboratories LTD.  Copyright (C) 1990
  7. Masanobu UMEDA.
  8.  
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.  
  13.    Permission is granted to copy and distribute modified versions of
  14. this manual under the conditions for verbatim copying, provided also
  15. that the sections entitled "Distribution" and "GNUS General Public
  16. License" are included exactly as in the original, and provided that the
  17. entire resulting derived work is distributed under the terms of a
  18. permission notice identical to this one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that the sections entitled "Distribution" and "GNUS
  23. General Public License" may be included in a translation approved by
  24. the author instead of in the original English.
  25.  
  26. 
  27. File: gnus.info,  Node: Top,  Next: Distribution,  Up: (DIR)
  28.  
  29.    The GNUS Newsreader *******************
  30.  
  31.    GNUS is a network newsreader for GNU Emacs.  This Info file describes
  32. how to read and write USENET articles using GNUS and how to customize
  33. GNUS.
  34.  
  35. * Menu:
  36.  
  37. * Distribution::        How to get the latest GNUS distribution.
  38. * License::             Permission to redistribute GNUS on certain terms.
  39. * Acknowledgments::     I would like to thank many people who have helped me.
  40.  
  41. * Introduction::        An introduction to GNUS.
  42. * Installation::        How to install GNUS.
  43. * Starting up::         How to get started with GNUS.
  44. * Buffers of GNUS::     Buffers used by GNUS.
  45. * Newsgroup Commands::  Browsing through newsgroups.
  46. * Subject Commands::    Browsing through headers and messages.
  47. * Article Commands::    Commands for an article.
  48. * KILL File::           How to use KILL files.
  49.  
  50. * Customization::       How to customize GNUS.
  51. * Problems::            How to solve problems with GNUS.
  52. * Reporting Bugs::      Mailing lists and USENET newsgroups for GNUS lovers.
  53.                         How to report bugs.
  54.  
  55. * Key Index::           An item for each standard GNUS key sequence.
  56. * Command Index::       An item for each command name.
  57. * Variable Index::      An item for each documented variable.
  58. * Program Index::       An item for each program.
  59. * Concept Index::       An item for each concept.
  60.  
  61. 
  62. File: gnus.info,  Node: Distribution,  Next: License,  Prev: Top,  Up: Top
  63.  
  64. Distribution
  65. ************
  66.  
  67.    GNUS is "free"; this means that everyone is free to use it and free
  68. to redistribute it on a free basis.  GNUS is not in the public domain;
  69. it is copyrighted and there are restrictions on its distribution, but
  70. these restrictions are designed to permit everything that a good
  71. cooperating citizen would want to do.  What is not allowed is to try to
  72. prevent others from further sharing any version of GNUS that they might
  73. get from you.  The precise conditions appears following this section.
  74.  
  75.    The easiest way to get a copy of GNUS is from someone else who has
  76. it.  You need not ask for permission to do so, or tell any one else;
  77. just copy it.
  78.  
  79.    If you have access to the Internet, you can get the latest version of
  80. GNUS from tut.cis.ohio-state.edu [128.146.8.60] using anonymous ftp.
  81. You can also get it from osu-cis using anonymous uucp.
  82.  
  83.    You may also receive GNUS when you buy a computer.  Computer
  84. manufacturers are free to distribute copies on the same terms that apply
  85. to everyone else.  These terms require them to give you the full
  86. sources, including whatever changes they may have made, and to permit
  87. you to redistribute the GNUS received from them under the usual terms of
  88. the General Public License.  In other words, the program must be free
  89. for you when you get it, not just free for the manufacturer.
  90.  
  91.    If you cannot get a copy in any of those ways, you can order one from
  92. the author using electronic mail.  For further information, write to:
  93.  
  94.      umerin@mse.kyutech.ac.jp
  95.  
  96.    If you cannot reach the author using these addresses, try the
  97. following mailing list:
  98.  
  99.      info-gnus-english@tut.cis.ohio-state.edu
  100.  
  101. The list is intended to exchange useful information about GNUS, such as
  102. bug reports, useful hooks, and extensions.  Feel free to ask about the
  103. nearest machine that has GNUS installed.  Subscription requests for this
  104. list should be sent to:
  105.  
  106.      info-gnus-english-request@tut.cis.ohio-state.edu
  107.  
  108. *Note Reporting Bugs::, for more information on the mailing list.
  109.  
  110. 
  111. File: gnus.info,  Node: License,  Next: Acknowledgments,  Prev: Distribution,  Up: Top
  112.  
  113. GNUS General Public License
  114. ***************************
  115.  
  116.                         (Clarified 13 Jan 1989)
  117.  
  118.    The license agreements of most software companies keep you at the
  119. mercy of those companies.  By contrast, our general public license is
  120. intended to give everyone the right to share GNUS.  To make sure that
  121. you get the rights we want you to have, we need to make restrictions
  122. that forbid anyone to deny you these rights or to ask you to surrender
  123. the rights.  Hence this license agreement.
  124.  
  125.    Specifically, we want to make sure that you have the right to give
  126. away copies of GNUS, that you receive source code or else can get it if
  127. you want it, that you can change GNUS or use pieces of it in new free
  128. programs, and that you know you can do these things.
  129.  
  130.    To make sure that everyone has such rights, we have to forbid you to
  131. deprive anyone else of these rights.  For example, if you distribute
  132. copies of GNUS, you must give the recipients all the rights that you
  133. have.  You must make sure that they, too, receive or can get the source
  134. code.  And you must tell them their rights.
  135.  
  136.    Also, for our own protection, we must make certain that everyone
  137. finds out that there is no warranty for GNUS.  If GNUS is modified by
  138. someone else and passed on, we want its recipients to know that what
  139. they have is not what we distributed, so that any problems introduced
  140. by others will not reflect on our reputation.
  141.  
  142.    Therefore I (Masanobu Umeda) use the following terms, which are
  143. written for GNU Emacs by Richard Stallman and the Free Software
  144. Foundation, Inc.  They say what you must do to be allowed to distribute
  145. or change GNU Emacs.  You can know your right to distribute or change
  146. GNUS by replacing any occurrences of GNU Emacs with GNUS.  Please apply
  147. the same policies to GNUS as GNU Emacs.
  148.  
  149. Copying Policies
  150. ================
  151.  
  152.   1. You may copy and distribute verbatim copies of GNU Emacs source
  153.      code as you receive it, in any medium, provided that you
  154.      conspicuously and appropriately publish on each file a valid
  155.      copyright notice "Copyright (C) 1988 Free Software Foundation,
  156.      Inc." (or with whatever year is appropriate); keep intact the
  157.      notices on all files that refer to this License Agreement and to
  158.      the absence of any warranty; and give any other recipients of the
  159.      GNU Emacs program a copy of this License Agreement along with the
  160.      program.  You may charge a distribution fee for the physical act
  161.      of transferring a copy.
  162.  
  163.   2. You may modify your copy or copies of GNU Emacs source code or any
  164.      portion of it, and copy and distribute such modifications under
  165.      the terms of Paragraph 1 above, provided that you also do the
  166.      following:
  167.  
  168.         * cause the modified files to carry prominent notices stating
  169.           who last changed such files and the date of any change; and
  170.  
  171.         * cause the whole of any work that you distribute or publish,
  172.           that in whole or in part contains or is a derivative of GNU
  173.           Emacs or any part thereof, to be licensed at no charge to all
  174.           third parties on terms identical to those contained in this
  175.           License Agreement (except that you may choose to grant more
  176.           extensive warranty protection to some or all third parties,
  177.           at your option).
  178.  
  179.         * if the modified program serves as a text editor, cause it,
  180.           when started running in the simplest and usual way, to print
  181.           an announcement including a valid copyright notice "Copyright
  182.           (C) 1988 Free Software Foundation, Inc." (or with the year
  183.           that is appropriate), saying that there is no warranty (or
  184.           else, saying that you provide a warranty) and that users may
  185.           redistribute the program under these conditions, and telling
  186.           the user how to view a copy of this License Agreement.
  187.  
  188.         * You may charge a distribution fee for the physical act of
  189.           transferring a copy, and you may at your option offer warranty
  190.           protection in exchange for a fee.
  191.  
  192.      Mere aggregation of another unrelated program with this program
  193.      (or its derivative) on a volume of a storage or distribution
  194.      medium does not bring the other program under the scope of these
  195.      terms.
  196.  
  197.   3. You may copy and distribute GNU Emacs (or a portion or derivative
  198.      of it, under Paragraph 2) in object code or executable form under
  199.      the terms of Paragraphs 1 and 2 above provided that you also do
  200.      one of the following:
  201.  
  202.         * accompany it with the complete corresponding machine-readable
  203.           source code, which must be distributed under the terms of
  204.           Paragraphs 1 and 2 above; or,
  205.  
  206.         * accompany it with a written offer, valid for at least three
  207.           years, to give any third party free (except for a nominal
  208.           shipping charge) a complete machine-readable copy of the
  209.           corresponding source code, to be distributed under the terms
  210.           of Paragraphs 1 and 2 above; or,
  211.  
  212.         * accompany it with the information you received as to where the
  213.           corresponding source code may be obtained.  (This alternative
  214.           is allowed only for noncommercial distribution and only if you
  215.           received the program in object code or executable form alone.)
  216.  
  217.      For an executable file, complete source code means all the source
  218.      code for all modules it contains; but, as a special exception, it
  219.      need not include source code for modules which are standard
  220.      libraries that accompany the operating system on which the
  221.      executable file runs.
  222.  
  223.   4. You may not copy, sublicense, distribute or transfer GNU Emacs
  224.      except as expressly provided under this License Agreement.  Any
  225.      attempt otherwise to copy, sublicense, distribute or transfer GNU
  226.      Emacs is void and your rights to use GNU Emacs under this License
  227.      agreement shall be automatically terminated.  However, parties who
  228.      have received computer software programs from you with this
  229.      License Agreement will not have their licenses terminated so long
  230.      as such parties remain in full compliance.
  231.  
  232.   5. If you wish to incorporate parts of GNU Emacs into other free
  233.      programs whose distribution conditions are different, write to the
  234.      Free Software Foundation.  We have not yet worked out a simple
  235.      rule that can be stated here, but we will often permit this.  We
  236.      will be guided by the two goals of preserving the free status of
  237.      all derivatives of our free software and of promoting the sharing
  238.      and reuse of software.
  239.  
  240.    Your comments and suggestions about our licensing policies and our
  241. software are welcome!  Please contact the Free Software Foundation,
  242. Inc., 675 Mass Ave, Cambridge, MA 02139.
  243.  
  244. NO WARRANTY
  245. ===========
  246.  
  247.    BECAUSE GNUS IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY NO
  248. WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW.  EXCEPT WHEN
  249. OTHERWISE STATED IN WRITING, FUJITSU LABORATORIES LTD., MASANOBU UMEDA
  250. AND/OR OTHER PARTIES PROVIDE GNUS "AS IS" WITHOUT WARRANTY OF ANY KIND,
  251. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  252. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  253. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS
  254. WITH YOU.  SHOULD THE GNUS PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST
  255. OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  256.  
  257.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL FUJITSU
  258. LABORATORIES LTD., MASANOBU UMEDA, AND/OR ANY OTHER PARTY WHO MAY
  259. MODIFY AND REDISTRIBUTE GNUS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  260. DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL,
  261. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  262. TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  263. INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE
  264. PROGRAM TO OPERATE WITH PROGRAMS NOT DISTRIBUTED BY MASANOBU UMEDA) THE
  265. PROGRAM, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
  266. DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  267.  
  268. 
  269. File: gnus.info,  Node: Acknowledgments,  Next: Introduction,  Prev: License,  Up: Top
  270.  
  271. Acknowledgments
  272. ***************
  273.  
  274.    The author would like to thank all those who have helped design and
  275. develop GNUS, and who tested non stable code at their own risk.
  276.  
  277.    Haruo Yokota, Hiroyuki Yoshida, and Kohji Akiyama contributed many
  278. valuable suggestions in the early stages of the development of GNUS.
  279. Nobuyuki Hiraoka, Tsuneo Nakata, and Mark Feldman patiently tested non
  280. stable code and contributed valuable comments.  Mark Feldman also helped
  281. with proofreading.  Mike Khaw, Kouich Kumon, and Mitsuhiro Kishimoto
  282. helped contribute the name GNUS.  Itaru Ichikawa helped implement the
  283. caesar rotations for Japanese characters.  Yasunari Itoh, Akio Shibata,
  284. and Ken-ichi Sakaeda made this software available on SX/A Emacs and some
  285. old versions of GNU Emacs.  Leonard H.  Tower Jr., Bob Sutterfield, and
  286. Karl Kleinpaste helped create mailing lists for GNUS users.  Bob
  287. Sutterfield has also been managing the info-gnus-english mailing list.
  288. Jordan K.  Hubbard helped with proofreading of this Texinfo manual.
  289.  
  290.    The author would also like to thank many other GNUS users who have
  291. sent comments, suggestions, and bug fixes.  Thanks also go to Richard
  292. Stallman and the Free Software Foundation for their good work.
  293.  
  294. 
  295. File: gnus.info,  Node: Introduction,  Next: Installation,  Prev: Acknowledgments,  Up: Top
  296.  
  297. Introduction
  298. ************
  299.  
  300.    GNUS is a program for reading and writing USENET news using GNU
  301. Emacs.  This manual documents the use and simple customization of GNUS.
  302.  
  303.    Unlike other conventional newsreaders such as rn which was (:-) the
  304. most popular newsreader in the world, GNUS runs inside the GNU Emacs
  305. editor as a subsystem.  This means that there is no need to invoke an
  306. editor when composing articles or mail.  The reading and writing of
  307. articles can be done in the same Emacs environment you usually work in.
  308.  
  309.    Like rrn, a remote version of rn, GNUS can use computer networks for
  310. retrieving articles.  This means that there is no need to have a local
  311. copy of the news spool, to mount a remote file system over the network,
  312. or to run Emacs on a remote machine.  Its great advantage is to balance
  313. loads and exploit resources of the entire computer system in a
  314. distributed environment.  The protocol used by GNUS is "NNTP", the
  315. Network News Transfer Protocol, defined by RFC977.
  316.  
  317.    Unlike rrn, GNUS can talk to many NNTP servers easily.  The only
  318. thing you have to do is to create startup files for each NNTP server.
  319.  
  320.    Like other libraries of GNU Emacs, GNUS is completely written in
  321. Emacs lisp.  This means that GNUS is highly extensible and customizable
  322. just like GNU Emacs.  It is possible to change the behavior of GNUS and
  323. extend its functions by using variables and hooks.
  324.  
  325.    GNUS is pronounced *"NUZ"*.  Never call it *"ghu-NUZ"* nor
  326. *"ghu-NAS"*.
  327.  
  328.    This manual is currently in progress and thus is incomplete.  Your
  329. suggestions, bug fixes, and contributions are welcome.
  330.  
  331. 
  332. File: gnus.info,  Node: Installation,  Next: Starting up,  Prev: Introduction,  Up: Top
  333.  
  334. Installing GNUS
  335. ***************
  336.  
  337.    Installation of GNUS and some initialization of your computing
  338. environment are described in this chapter.  Please read the following
  339. sections carefully before getting started with GNUS.
  340.  
  341. * Menu:
  342.  
  343. * Files of GNUS::       How many files of GNUS are there?
  344. * Compilation::         How to byte-compile lisp sources.
  345. * Autoloading::         How to define autoload entries.
  346. * Environment::         How to define your environment.
  347. * Texinfo Manual::      How to install an Info file and print the manual.
  348.  
  349. 
  350. File: gnus.info,  Node: Files of GNUS,  Next: Compilation,  Prev: Installation,  Up: Installation
  351.  
  352. Files of GNUS
  353. =============
  354.  
  355.    Unpacking the shar files will produce the following files.  They are
  356. the Emacs lisp sources, a C source, a Texinfo manual of GNUS, and a
  357. Makefile.
  358.  
  359. `gnus.el'
  360.      Main part of GNUS newsreader.
  361.  
  362. `gnuspost.el'
  363.      Post news commands.
  364.  
  365. `gnusmail.el'
  366.      Mail reply commands.
  367.  
  368. `gnusmisc.el'
  369.      Miscellaneous commands.
  370.  
  371. `nntp.el'
  372.      NNTP package.
  373.  
  374. `nnspool.el'
  375.      A package accessing local news spool like NNTP.
  376.  
  377. `mhspool.el'
  378.      A package accessing private directory like NNTP.
  379.  
  380. `timezone.el'
  381.      A general time zone handling package useful not only for GNUS.
  382.  
  383. `tcp.el'
  384.      Patches to some versions of GNU Emacs which do not have the
  385.      function `open-network-stream'.
  386.  
  387. `tcp.c'
  388.      C program for external TCP/IP implementation.  This is used with
  389.      `tcp.el'.
  390.  
  391. `gnus.texinfo'
  392.      Texinfo manual of GNUS.
  393.  
  394. `Makefile'
  395.      Makefile to byte-compile the lisp files using the `make' command.
  396.  
  397. 
  398. File: gnus.info,  Node: Compilation,  Next: Autoloading,  Prev: Files of GNUS,  Up: Installation
  399.  
  400. Byte-Compilation
  401. ================
  402.  
  403.    Move the lisp files, the C file, and `Makefile' to the appropriate
  404. directory in the search path defined by the variable `load-path'.
  405. Before actually byte-compiling the lisp files, make sure there are no
  406. byte-compiled files of older versions of GNUS in that directory.
  407. Remove or rename such files as the byte-compiler may be confused by old
  408. macro definitions.  If you can use the `make' command, you don't have
  409. to take care of the dependencies.
  410.  
  411.    The C file `tcp.c' should be compiled with a C compiler and
  412. installed in a directory in the search path defined by the variable
  413. `exec-path', if this is required.
  414.  
  415.    If you can use the `make' command, just type `make' in a Unix shell.
  416. All the lisp files will be byte-compiled.  Otherwise, byte-compile
  417. lisp files in the following order according to your computing
  418. environment by yourself:
  419.  
  420.   1. Byte-compile `nntp.el', `gnus.el', `gnuspost.el', `gnusmail.el',
  421.      and `gnusmisc.el' in this order.
  422.  
  423.   2. Byte-compile `timezone.el' if you didn't have it.
  424.  
  425.   3. Byte-compile `nnspool.el' if you want to use the local news spool
  426.      of your machine instead of NNTP (*note Local News Spool::.).
  427.  
  428.   4. Byte-compile `mhspool.el' if you want to read articles or mail in
  429.      your private directory using GNUS (*note Private Directory::.).
  430.  
  431.   5. Compile and install `tcp.el' and `tcp.c' if TCP/IP is not
  432.      supported by Emacs but is supported by your operating system.
  433.  
  434.    `tcp.el' defines the function `open-network-stream', and `tcp.c' is
  435. an emulation program for the stream used by the function.  If you
  436. modified `tcp.c' for your system, please send the author the diffs.
  437. Some of them will be included in the future releases of GNUS.
  438.  
  439. 
  440. File: gnus.info,  Node: Autoloading,  Next: Environment,  Prev: Compilation,  Up: Installation
  441.  
  442. Autoloading
  443. ===========
  444.  
  445.    It is useful to define autoload entries in `.emacs', `site-init.el'
  446. or `default.el' as follows:
  447.  
  448.      (autoload 'gnus "gnus" "Read network news." t)
  449.      (autoload 'gnus-post-news "gnuspost" "Post a new news." t)
  450.  
  451. 
  452. File: gnus.info,  Node: Environment,  Next: Texinfo Manual,  Prev: Autoloading,  Up: Installation
  453.  
  454. Environment
  455. ===========
  456.  
  457.    The NNTP server and its service name, your domain and organization,
  458. and other important definitions of your computing environment are
  459. described in this section.  Since these definitions depend heavily on
  460. your environment, you'd better be familiar with the operating system you
  461. are using. Knowledge of the USENET software is also important.
  462.  
  463. * Menu:
  464.  
  465. * Server:  NNTP Server.         How to define NNTP server.
  466. * Service: NNTP Service.        How to define NNTP service.
  467. * Domain::                      How to define your domain and organization.
  468. * GENERICFROM::                 How to use GENERICFROM feature.
  469. * GENERICPATH::                 How to use GENERICPATH feature.
  470. * Startup File::                About the startup files of GNUS.
  471.  
  472. 
  473. File: gnus.info,  Node: NNTP Server,  Next: NNTP Service,  Prev: Environment,  Up: Environment
  474.  
  475. NNTP Server
  476. -----------
  477.  
  478.    The variable `gnus-nntp-server' specifies the default NNTP server.
  479. To define the server `flab', put the following code in `.emacs',
  480. `site-init.el' or `default.el':
  481.  
  482.      (setq gnus-nntp-server "flab")
  483.  
  484.    The variable `gnus-nntp-server' is initialized from the `NNTPSERVER'
  485. environment variable.  To define the server using the `NNTPSERVER'
  486. environment variable, put the following code in `.login':
  487.  
  488.      setenv NNTPSERVER "flab"
  489.  
  490.    If an NNTP server is preceded by a colon such as `:Mail', the user's
  491. private directory `~/Mail' is used as the news spool.  This makes it
  492. possible to read mail stored in MH folders or articles saved by GNUS.
  493. *Note Private Directory::, for more information.
  494.  
  495.    GNUS will ask you for the NNTP server at start up time unless it is
  496. defined.  Even if the default server is defined, it is possible to
  497. choose another server by invoking GNUS with a prefix argument like `C-u
  498. M-x gnus' (*note Getting Started::.).
  499.  
  500. 
  501. File: gnus.info,  Node: NNTP Service,  Next: Domain,  Prev: NNTP Server,  Up: Environment
  502.  
  503. NNTP Service
  504. ------------
  505.  
  506.    The default service name of NNTP is `"nntp"'.  You may, however,
  507. have to define the service name as the number `119' as follows:
  508.  
  509.      (setq gnus-nntp-service 119)
  510.  
  511.    If you'd like to use a local news spool of your machine directly
  512. instead of NNTP, set the variable to `nil' as follows:
  513.  
  514.      (setq gnus-nntp-service nil)
  515.  
  516. In this case, the NNTP server must be a local host name returned by the
  517. function `system-name' (*note Local News Spool::.).
  518.  
  519. 
  520. File: gnus.info,  Node: Domain,  Next: GENERICFROM,  Prev: NNTP Service,  Up: Environment
  521.  
  522. Domain and Organization
  523. -----------------------
  524.  
  525.    "Domain" and "organization" must be defined before you post your
  526. first article, because they are included in all articles you post and
  527. will be used for identifying who you are.
  528.  
  529.    "Domain" is the domain part of your mail address excluding the local
  530. host name.  For example, if your mail address is
  531. `umerin@photon.stars.flab.Fujitsu.CO.JP' and the local host name is
  532. `photon', your domain is `stars.flab.Fujitsu.CO.JP'.  If the function
  533. `system-name' of your Emacs returns the full Internet name, you do not
  534. have to define the domain.
  535.  
  536.    "Organization" is the organization you belong to.  It must be
  537. defined unless it is defined in the file `/usr/lib/news/organization'.
  538.  
  539.    To define the domain `stars.flab.Fujitsu.CO.JP' and the organization
  540. `Fujitsu Laboratories Ltd., Kawasaki, Japan.' using lisp variables, put
  541. the following code in `.emacs', `site-init.el' or `default.el'.  If you
  542. are a system administrator and are installing GNUS for other users,
  543. `site-init.el' is the best place to define this because the domain and
  544. organization are common to all users of the system.
  545.  
  546.      (setq gnus-local-domain "stars.flab.Fujitsu.CO.JP")
  547.      (setq gnus-local-organization
  548.            "Fujitsu Laboratories Ltd., Kawasaki, Japan.")
  549.  
  550.    The `DOMAINNAME' and `ORGANIZATION' environment variables are used
  551. instead, if defined.  To define these variables, put the following code
  552. in `.login'.
  553.  
  554.      setenv DOMAINNAME   "stars.flab.Fujitsu.CO.JP"
  555.      setenv ORGANIZATION "Fujitsu Laboratories Ltd., Kawasaki, Japan."
  556.  
  557.    If the value of the `ORGANIZATION' environment variable or the
  558. variable `gnus-local-organization' begins with a slash, it is taken as
  559. the name of a file whose contents are read for the value.  If neither
  560. of these is defined, and a file `~/.organization-DISTRIBUTION' or
  561. `~/.organization' exists, the contents of that file are used.  If
  562. neither of them does not exist, and the file
  563. `/usr/lib/news/organization' exists, its contents are used.
  564.  
  565. 
  566. File: gnus.info,  Node: GENERICFROM,  Next: GENERICPATH,  Prev: Domain,  Up: Environment
  567.  
  568. GENERICFROM
  569. -----------
  570.  
  571.    If the variable `gnus-use-generic-from' is non-`nil', the local host
  572. name of your machine will not appear in the `From:' field of article
  573. headers you post.  This is called the "GENERICFROM" feature in the
  574. Bnews system.  This may be useful if there are many workstations
  575. connected to each other in a local area network, and aliases service or
  576. automatic forwarding of mail is supported between the workstations.
  577.  
  578.    To use the GENERICFROM, put the following code in `.emacs',
  579. `site-init.el' or `default.el'.  If you are a system administrator and
  580. are installing GNUS for other users, `site-init.el' is the best place
  581. to define it because the definition is common to all users of the
  582. system having the same domain and organization (*note Domain and
  583. Organization: Domain.).
  584.  
  585.      (setq gnus-use-generic-from t)
  586.  
  587.    As a special case of the GENERICFROM feature, if the variable
  588. `gnus-use-generic-from' is a string, it is used as your domain instead
  589. of the definition of the environment variable `DOMAINNAME' or the
  590. variable `gnus-local-domain' (*note Domain and Organization: Domain.).
  591.  
  592. 
  593. File: gnus.info,  Node: GENERICPATH,  Next: Startup File,  Prev: GENERICFROM,  Up: Environment
  594.  
  595. GENERICPATH
  596. -----------
  597.  
  598.    If the variable `gnus-use-generic-path' is `nil', the NNTP server
  599. name followed by the user login name is used in the `Path:' field of
  600. article headers you post.  If it is a string, the string followed by
  601. the user login name is used instead.  Otherwise, if it is non-`nil',
  602. only the user login name is used.  This is called the "GENERICPATH"
  603. feature in the Bnews system.
  604.  
  605.    For example, to define the generic path `flab', put the following
  606. codes in `.emacs', `site-init.el' or `default.el'.  If you are a system
  607. administrator and are installing GNUS for other users, `site-init.el'
  608. is the best place to define it because the definition is common to all
  609. users of the system having the same domain and organization (*note
  610. Domain and Organization: Domain.).
  611.  
  612.      (setq gnus-use-generic-path "flab")
  613.  
  614. In this case, the `Path:' field will be generated as `Path: flab!USER'.
  615.  
  616. 
  617. File: gnus.info,  Node: Startup File,  Prev: GENERICPATH,  Up: Environment
  618.  
  619. Startup File
  620. ------------
  621.  
  622.    "Startup file" is a file recording information on articles you have
  623. already read.  GNUS uses `.newsrc' for the startup file as in the Bnews
  624. system.  If you think you will talk to exactly one NNTP server, you can
  625. use it without any problems.  Otherwise, if you want to talk to several
  626. NNTP servers, you'd better use server specific startup files since
  627. startup files are not portable between servers.  The server specific
  628. startup file for an NNTP server on a machine SERVER is a file named
  629. `.newsrc-SERVER'.  For example, `.newsrc-photon' is for an NNTP server
  630. on a machine named `photon'.  The primary name of the startup file,
  631. `.newsrc', is specified by the variable `gnus-startup-file' (*note
  632. Variables::.).
  633.  
  634.    GNUS automatically adds newly created newsgroups to a startup file
  635. when getting started.  To prevent adding the newsgroups under some
  636. newsgroup hierarchies, you can use the options line in the startup file
  637. or the variable `gnus-subscribe-newsgroup-method' provided for
  638. subscription method customization.  *Note Variables::, for more
  639. information on the variable customization.
  640.  
  641.    Option `-n' of the options line in the startup file is recognized
  642. properly the same as for the Bnews system.  For example, if the options
  643. line is `options -n !talk talk.rumors', newsgroups under the `talk'
  644. hierarchy except for `talk.rumors' are ignored while checking new
  645. newsgroups.  These ignored newsgroups can be added manually using the
  646. command `U' (`gnus-Group-unsubscribe-group') in the Newsgroup buffer.
  647. Use the commands `C-k' and `C-w' (`gnus-Group-kill-group' and
  648. `gnus-Group-kill-region') to kill newsgroups from the startup file per
  649. a newsgroup basis.  *Note Maintenance::, for more information.
  650.  
  651.    Once a startup file is updated by GNUS, the "quick startup file" of
  652. which the file name is generated by appending `.el' to that of the raw
  653. startup file is also created.  The quick startup file can be read by
  654. Emacs faster than the raw startup file since all information in the
  655. file is in lisp form.  If there is a quick startup file and it is newer
  656. than the raw startup file, the quick startup file is loaded instead of
  657. the raw startup file.  If the raw startup file is newer, it is normally
  658. read after loading the quick startup file.  You should not remove the
  659. quick startup file because it contains additional information.
  660. Instead, make the raw startup file newer than that by touching it or
  661. force GNUS to read it by using the command `R' (`gnus-Group-restart')
  662. in the Newsgroup buffer if you want to reflect the changes of the raw
  663. startup file to GNUS.
  664.  
  665. 
  666. File: gnus.info,  Node: Texinfo Manual,  Prev: Environment,  Up: Installation
  667.  
  668. Texinfo Manual
  669. ==============
  670.  
  671.    `gnus.texinfo' is a manual of GNUS written in Texinfo format.  This
  672. file can be printed using TeX, and also can be read using Info Mode of
  673. Emacs.
  674.  
  675.    *note Creating an Info File: (texinfo)Creating an Info File, to
  676. create an on-line Info file from the Texinfo manual.  If you are not
  677. allowed to create the Info file in the standard Info directory specified
  678. by the variable `Info-directory', create it in your private directory
  679. and set the variable `gnus-Info-directory' to the directory.
  680.  
  681.    If this Info file is installed, you can read the documentation of
  682. GNUS according to the current major mode of GNUS.  The command
  683. `gnus-Info-find-node' for reading appropriate Info nodes of the Info
  684. file is assigned to `C-c C-i' in all major modes of GNUS.
  685.  
  686.    *note Printing Hardcopy: (texinfo)Printing Hardcopy, to print a
  687. hardcopy of the manual.
  688.  
  689. 
  690. File: gnus.info,  Node: Starting up,  Next: Buffers of GNUS,  Prev: Installation,  Up: Top
  691.  
  692. Starting up GNUS
  693. ****************
  694.  
  695.    This chapter describes how to get started GNUS, how to use a local
  696. news spool directly, and how to read private directory.
  697.  
  698. * Menu:
  699.  
  700. * Getting Started::     How to get started GNUS.
  701. * Local News Spool::    How to use a local news spool.
  702. * Private Directory::   How to read a private directory.
  703.  
  704. 
  705. File: gnus.info,  Node: Getting Started,  Next: Local News Spool,  Prev: Starting up,  Up: Starting up
  706.  
  707. Getting Started GNUS
  708. ====================
  709.  
  710.    Type `M-x gnus' at the top level of GNU Emacs to invoke GNUS.
  711. Unless a default NNTP server is defined, you will be asked for the name
  712. of the server.  The NNTP server can be changed at startup time by giving
  713. a prefix argument to the command even if a default server is defined.
  714. *Note NNTP Server::, to define the default server.
  715.  
  716. `M-x gnus'
  717.      Run GNUS using the default NNTP server.
  718.  
  719. `C-u M-x gnus'
  720.      Run GNUS without using the default NNTP server.
  721.  
  722. 
  723. File: gnus.info,  Node: Local News Spool,  Next: Private Directory,  Prev: Getting Started,  Up: Starting up
  724.  
  725. Using Local News Spool
  726. ======================
  727.  
  728.    If the NNTP server is the local host name (exactly the same as the
  729. value returned by the function `system-name'), and the variable
  730. `gnus-nntp-service' is nil, GNUS looks up the local news spool of your
  731. machine directly instead of NNTP (*note NNTP Service::.).
  732.  
  733.    It may be a good idea not to use NNTP if you wish to reduce network
  734. traffic (even if an NNTP server is running on the local machine) though
  735. commands for retrieving articles by Message-IDs may take longer or not
  736. work at all.  *Note Referencing Articles::, to refer to articles by the
  737. Message-IDs, and *note Spool Variables::., for more information on the
  738. restrictions.
  739.  
  740. 
  741. File: gnus.info,  Node: Private Directory,  Prev: Local News Spool,  Up: Starting up
  742.  
  743. Reading a Private Directory
  744. ===========================
  745.  
  746.    If an NNTP server is preceded by a colon such as `:Mail', the user's
  747. private directory `~/Mail' is used as the news spool.  This makes it
  748. possible to read mail stored in MH folders or articles saved by GNUS.
  749. An active file for the directory is generated from files of which the
  750. file name consists of only numeric characters, and other files
  751. containing non-numeric characters in their file name are ignored.
  752.  
  753.    A server specific startup file for each directory must be created
  754. before starting GNUS.  For example, a startup file for the directory
  755. `~/Mail' is a file named `.newsrc-:Mail'.  *Note Startup File::, for
  756. more information on the server specific startup file.
  757.  
  758. 
  759. File: gnus.info,  Node: Buffers of GNUS,  Next: Newsgroup Commands,  Prev: Starting up,  Up: Top
  760.  
  761. Buffers of GNUS
  762. ***************
  763.  
  764.    Basically GNUS uses three buffers in Emacs: Newsgroup buffer, Subject
  765. buffer, and Article buffer.  Each of them is associated with a specific
  766. major mode of Emacs.  The configuration of the windows displaying these
  767. buffers are customizable by using the variable
  768. `gnus-window-configuration'.  *Note Variables::, for more information
  769. on customizing the window configuration.
  770.  
  771. * Menu:
  772.  
  773. * Newsgroup Buffer:: a buffer for listing newsgroups.
  774. * Subject Buffer::   a buffer for listing subjects and other important headers.
  775. * Article Buffer::   a buffer for displaying messages of articles.
  776.  
  777. 
  778. File: gnus.info,  Node: Newsgroup Buffer,  Next: Subject Buffer,  Prev: Buffers of GNUS,  Up: Buffers of GNUS
  779.  
  780. Newsgroup Buffer
  781. ================
  782.  
  783.    "Newsgroup buffer" is for listing newsgroups.  The major mode of
  784. this buffer is "Group Mode".  The buffer is created and popped up when
  785. GNUS starts.  Newsgroups which are subscribed to and contain unread
  786. articles are usually listed in the buffer.  If there is no such
  787. newsgroup, the buffer will be empty and a message `No news is good
  788. news.' will be displayed in the echo area of Emacs.
  789.  
  790.    The contents of a Newsgroup buffer looks something like the
  791. following:
  792.  
  793.      SM  NUMBER: NEWSGROUP
  794.  
  795. S
  796.      A character indicating whether the newsgroup is subscribed to.  `U'
  797.      means the newsgroup is unsubscribed.  ` ' means it is subscribed
  798.      to.
  799.  
  800. M
  801.      A character indicating whether there are unread articles in the
  802.      newsgroup.  `*' means there are no newly arrived articles in the
  803.      newsgroup.  ` ' means there are newly arrived articles.
  804.  
  805. NUMBER
  806.      The number of unread articles in the newsgroup.
  807.  
  808. NEWSGROUP
  809.      The name of the newsgroup.
  810.  
  811. 
  812. File: gnus.info,  Node: Subject Buffer,  Next: Article Buffer,  Prev: Newsgroup Buffer,  Up: Buffers of GNUS
  813.  
  814. Subject Buffer
  815. ==============
  816.  
  817.    "Subject buffer" is for listing subjects and other important headers
  818. of articles.  The major mode of the buffer is "Subject Mode".  The
  819. buffer is created for each newsgroup when the newsgroup is selected in
  820. the Newsgroup buffer.
  821.  
  822.    The contents of a Subject buffer looks something like the following:
  823.  
  824.      S NUMBER:C[LINES:AUTHOR] SUBJECT
  825.  
  826. S
  827.      A character indicating whether an article is newly arrived.  ` '
  828.      means the article is newly arrived.  `D' means it was read and
  829.      marked so.  `-' means it was read once but marked as unread again.
  830.  
  831. NUMBER
  832.      The number assigned to the article.
  833.  
  834. C
  835.      A character indicating which article is currently selected.  `+' is
  836.      placed on the current article.
  837.  
  838. LINES
  839.      The number of lines of the article body.
  840.  
  841. AUTHOR
  842.      Mail address of the author of the article.
  843.  
  844. SUBJECT
  845.      Subject of the article.
  846.  
  847.    Strings between `[' and `]' are optional, and can be customized
  848. using the variable `gnus-optional-headers'.  *Note Variables::, and
  849. *note Hooks::., for more information on customization.
  850.  
  851. 
  852. File: gnus.info,  Node: Article Buffer,  Prev: Subject Buffer,  Up: Buffers of GNUS
  853.  
  854. Article Buffer
  855. ==============
  856.  
  857.    "Article buffer" is for displaying articles.  The major mode of the
  858. buffer is "Article Mode".  Very few commands are available in this
  859. buffer because most operations on the buffer can be done in the Subject
  860. buffer.
  861.  
  862. 
  863. File: gnus.info,  Node: Newsgroup Commands,  Next: Subject Commands,  Prev: Buffers of GNUS,  Up: Top
  864.  
  865. Newsgroup Commands
  866. ******************
  867.  
  868.    The Newsgroup buffer is intended to show newsgroups which are
  869. subscribed to and contain unread articles.  Unsubscribed newsgroups or
  870. newsgroups containing no unread articles are not usually displayed in
  871. the buffer.
  872.  
  873.    Commands for browsing through newsgroups, selecting newsgroups to
  874. read, and maintaining newsgroups are described in this chapter.
  875.  
  876. * Menu:
  877.  
  878. * Browsing Newsgroups::         Browsing through newsgroups.
  879. * Selecting a Newsgroup::       Selecting a newsgroup to read articles.
  880. * Maintenance::                 Maintaining newsgroups.
  881. * Exiting GNUS::                How to exit GNUS.
  882. * Other Newsgroup Commands::    Other miscellaneous commands.
  883.  
  884. 
  885. File: gnus.info,  Node: Browsing Newsgroups,  Next: Selecting a Newsgroup,  Prev: Newsgroup Commands,  Up: Newsgroup Commands
  886.  
  887. Walking Around Newsgroups
  888. =========================
  889.  
  890.    First of all, you have to move the point to a newsgroup to read
  891. articles in it.
  892.  
  893. `n'
  894.      Move point to the next newsgroup containing unread articles
  895.      (`gnus-Group-next-unread-group').
  896.  
  897. `p'
  898. `DEL'
  899.      Move point to the previous newsgroup containing unread articles
  900.      (`gnus-Group-prev-unread-group').
  901.  
  902. `N'
  903. `C-n'
  904.      Move point to the next newsgroup (`gnus-Group-next-group').
  905.  
  906. `P'
  907. `C-p'
  908.      Move point to the previous newsgroup (`gnus-Group-prev-group').
  909.  
  910. `j NEWSGROUP RET'
  911.      Move point to the specified NEWSGROUP (`gnus-Group-jump-to-group').
  912.  
  913. `/'
  914.      Do an incremental search forward (`isearch-forward').
  915.  
  916. `<'
  917.      Move point to the beginning of the buffer (`beginning-of-buffer').
  918.  
  919. `>'
  920.      Move point to the end of the buffer (`end-of-buffer').
  921.  
  922. `r'
  923.      Restrict visible newsgroups to the current region specified by the
  924.      point and the mark (`gnus-Group-restrict-groups').
  925.  
  926.    The command `j' (`gnus-Group-jump-to-group') reads a newsgroup name
  927. interactively, and moves the point to it.  If there is no such
  928. newsgroup in the buffer, a line for the newsgroup is inserted at the
  929. beginning of the buffer.
  930.  
  931.    The command `r' (`gnus-Group-restrict-groups') restricts visible
  932. newsgroups to the current region specified by the point and the mark.
  933. This is useful if you want to concentrate on a restricted set of
  934. newsgroups in a region.  Type `C-x w' (`widen') to remove the
  935. restriction.
  936.  
  937. 
  938. File: gnus.info,  Node: Selecting a Newsgroup,  Next: Maintenance,  Prev: Browsing Newsgroups,  Up: Newsgroup Commands
  939.  
  940. Selecting a Newsgroup
  941. =====================
  942.  
  943.    If you successfully move the point to a desired newsgroup, you can
  944. select the newsgroup to read articles by typing `SPC'
  945. (`gnus-Group-read-group') or `=' (`gnus-Group-select-group') on that
  946. line.
  947.  
  948. `SPC'
  949.      Select the newsgroup, and then select the first unread article
  950.      automatically (`gnus-Group-read-group').
  951.  
  952. `='
  953.      Select the newsgroup (`gnus-Group-select-group'). No article is
  954.      selected automatically.
  955.  
  956.    To prevent automatic selection of the first unread article even when
  957. the newsgroup is selected by the command `SPC'
  958. (`gnus-Group-read-group'), set the variable `gnus-auto-select-first' to
  959. `nil'.  If you want to change the value of the variable according to
  960. the selected newsgroups, set the variable in the hook
  961. `gnus-Select-group-hook'.
  962.  
  963.    If unread articles are contained in a selected newsgroup, they become
  964. ready to be read.  Otherwise, all articles in the newsgroup become ready
  965. to be read.  All articles in a newsgroup can be selected unconditionally
  966. by giving a prefix argument to the commands `SPC' and `='
  967. (`gnus-Group-read-group' and `gnus-Group-select-group').
  968.  
  969.    If the number of articles being selected is larger than the variable
  970. `gnus-large-newsgroup', the number of articles actually selected is
  971. asked for.  If the given value N is positive, the last N articles will
  972. be selected.  If N is negative, the first N articles will be selected.
  973. An empty string means to select all articles.
  974.  
  975.    *Note Variables::, and *note Hooks::., for more information on
  976. customization.
  977.  
  978. 
  979. File: gnus.info,  Node: Maintenance,  Next: Exiting GNUS,  Prev: Selecting a Newsgroup,  Up: Newsgroup Commands
  980.  
  981. Maintaining Newsgroups
  982. ======================
  983.  
  984.    Subscription of newsgroups, deletion of bogus newsgroups, and other
  985. related operations are described in this section.
  986.  
  987. `c'
  988.      Mark all articles as read in the newsgroup, preserving articles
  989.      marked as unread (`gnus-Group-catch-up').
  990.  
  991. `C'
  992.      Mark all articles as read in the newsgroup
  993.      (`gnus-Group-catch-up-all').
  994.  
  995. `l'
  996.      Redisplay newsgroups which are subscribed to and containing unread
  997.      articles (`gnus-Group-list-groups').
  998.  
  999. `L'
  1000.      Display all newsgroups unconditionally
  1001.      (`gnus-Group-list-all-groups').
  1002.  
  1003. `u'
  1004.      Unsubscribe from (or subscribe to) the newsgroup
  1005.      (`gnus-Group-unsubscribe-current-group').
  1006.  
  1007. `U NEWSGROUP RET'
  1008.      Unsubscribe from (or subscribe to) the specified NEWSGROUP
  1009.      (`gnus-Group-unsubscribe-group').  If it is not contained in the
  1010.      startup file, it is added to the file.
  1011.  
  1012. `C-k'
  1013.      Kill newsgroups from the startup file (`gnus-Group-kill-group').
  1014.      Numeric argument to the command specifies the number of newsgroups
  1015.      to be killed.
  1016.  
  1017. `C-w'
  1018.      Kill newsgroups in current region (excluding current line) from the
  1019.      startup file (`gnus-Group-kill-region').
  1020.  
  1021. `C-y'
  1022.      Yank the last newsgroup killed with the command `C-k' before the
  1023.      current line (`gnus-Group-yank-group').
  1024.  
  1025. `C-c C-y'
  1026.      Pop up a buffer for browsing the killed newsgroups
  1027.      (`gnus-Browse-killed-groups').
  1028.  
  1029. `b'
  1030.      Check bogus newsgroups (`gnus-Group-check-bogus-groups').  Bogus
  1031.      means non-active.
  1032.  
  1033. `g'
  1034.      Get newly arrived articles (`gnus-Group-get-new-news').  In fact,
  1035.      GNUS reads the active file from the NNTP server again.
  1036.  
  1037. `R'
  1038.      Force to read the raw startup file and get newly arrived articles
  1039.      (`gnus-Group-restart').
  1040.  
  1041.    The commands `c' and `C' (`gnus-Group-catch-up' and
  1042. `gnus-Group-catch-up-all') mark all articles as read in a newsgroup.
  1043. These commands do not take account of the cross-reference information
  1044. in the `Xref:' field, while the command `c'
  1045. (`gnus-Subject-catch-up-and-exit') in Subject Mode does.
  1046.  
  1047.    Only subscribed newsgroups containing unread articles are usually
  1048. displayed in the Newsgroup buffer.  Type `L'
  1049. (`gnus-Group-list-all-groups') to show all newsgroups which are
  1050. currently active.
  1051.  
  1052.    The command `U' (`gnus-Group-unsubscribe-group') reads a newsgroup
  1053. name interactively, and toggles its subscription flag if it is already
  1054. in the startup file.  Otherwise, if it is not contained in the startup
  1055. file, it is added to the file.  Thus, you can add newly created
  1056. newsgroups manually which are not added automatically because of the
  1057. options line in the startup file.  *Note Startup File::, for more
  1058. information on the startup file and options line.
  1059.  
  1060.    The commands `C-k' and `C-w' (`gnus-Group-kill-group' and
  1061. `gnus-Group-kill-region') kill newsgroups from both the Newsgroup
  1062. buffer and the raw startup file.  The killed newsgroups are stored in an
  1063. invisible kill ring and they can be yanked back later.  The command
  1064. `C-y' (`gnus-Group-yank-group') yank the last newsgroup killed.  The
  1065. command `C-c C-y' (`gnus-Browse-killed-groups') pops up the
  1066. "Browse-Killed buffer" for browsing all the killed newsgroups.  In this
  1067. buffer, the killed newsgroups can be yanked in any order using the
  1068. commands `y' and `C-y' (`gnus-Browse-killed-yank').  Thus, you can
  1069. change the order of newsgroups in the Newsgroup buffer without editing
  1070. the raw startup file directly.  Since the information on the killed
  1071. newsgroups will be stored in the quick startup file, they can be
  1072. restored any time unless you lose the file.
  1073.  
  1074.    A "bogus newsgroup" is one not in the list of active newsgroups in
  1075. the active file.  Bogus newsgroups which are deleted or renamed must be
  1076. deleted from the startup file (*note Startup File::.) explicitly by the
  1077. command `b' (`gnus-Group-check-bogus-groups').
  1078.  
  1079.    The command `R' (`gnus-Group-restart') is useful to restart GNUS
  1080. using the raw startup file instead of the quick startup file.
  1081. Generally speaking, if you want changes to the raw startup file to be
  1082. noticed by GNUS, it must be newer than the quick startup file.  *Note
  1083. Startup File::, for more information on the startup file.
  1084.  
  1085.    GNUS reads the active file at start up time to know about currently
  1086. active articles.  This information is not updated unless you force GNUS
  1087. to do so with the command `g' (`gnus-Group-get-new-news') or the
  1088. command `R' (`gnus-Group-restart').
  1089.  
  1090. 
  1091. File: gnus.info,  Node: Exiting GNUS,  Next: Other Newsgroup Commands,  Prev: Maintenance,  Up: Newsgroup Commands
  1092.  
  1093. Exiting GNUS
  1094. ============
  1095.  
  1096. `s'
  1097. `x'
  1098.      Update the startup file `.newsrc' (`gnus-Group-force-update').
  1099.  
  1100. `z'
  1101.      Suspend the current GNUS session to make it possible to resume it
  1102.      later (`gnus-Group-suspend').
  1103.  
  1104. `q'
  1105.      Update the startup file `.newsrc', and then exit GNUS
  1106.      (`gnus-Group-exit').
  1107.  
  1108. `Q'
  1109.      Exit GNUS without updating the startup file `.newsrc'
  1110.      (`gnus-Group-quit').
  1111.  
  1112.    If a GNUS session is suspended by the command `z'
  1113. (`gnus-Group-suspend'), it is possible to resume it later without any
  1114. time-consuming initializations.  Switch to the Newsgroup buffer and
  1115. type `g' (`gnus-Group-get-new-news') to get newly arrived articles if
  1116. you want to resume the suspended GNUS session.  It is a good idea to
  1117. update the startup file (*note Startup File::.) before suspending GNUS.
  1118.  
  1119.    If you want to forget what you read this GNUS session, exit GNUS by
  1120. the command `Q' (`gnus-Group-quit').  Otherwise, exit by the command
  1121. `q' (`gnus-Group-exit') to update the startup file.
  1122.  
  1123.    The hook `gnus-Exit-gnus-hook' is called when exiting GNUS, and the
  1124. hook `gnus-Suspend-gnus-hook' is called when suspending GNUS.  If you
  1125. want to clear out Emacs buffers which were created by GNUS and remain
  1126. afterwards, use these hooks.
  1127.  
  1128. 
  1129. File: gnus.info,  Node: Other Newsgroup Commands,  Prev: Exiting GNUS,  Up: Newsgroup Commands
  1130.  
  1131. Miscellaneous Commands
  1132. ======================
  1133.  
  1134.    Other miscellaneous commands are described here.
  1135.  
  1136. `a'
  1137.      Compose a new article (`gnus-Group-post-news').  *Note Followup
  1138.      and Reply::, for more information.
  1139.  
  1140. `M-k'
  1141.      Edit a local KILL file (`gnus-Group-edit-local-kill').  *Note KILL
  1142.      File::, for more information.
  1143.  
  1144. `M-K'
  1145.      Edit a global KILL file (`gnus-Group-edit-global-kill').  *Note
  1146.      KILL File::, for more information.
  1147.  
  1148. `V'
  1149.      Print version number of this GNUS (`gnus-version').
  1150.  
  1151. `?'
  1152.      Describe Group Mode commands briefly
  1153.      (`gnus-Group-describe-briefly').
  1154.  
  1155. `C-c C-i'
  1156.      Read Info on Group Mode (`gnus-Info-find-node').  *Note Texinfo
  1157.      Manual::, to prepare an Info file of GNUS.
  1158.  
  1159. 
  1160. File: gnus.info,  Node: Subject Commands,  Next: Article Commands,  Prev: Newsgroup Commands,  Up: Top
  1161.  
  1162. Subject Commands
  1163. ****************
  1164.  
  1165.    The Subject buffer is intended to show interesting headers of
  1166. articles in a newsgroup and to help you know what kind of discussions
  1167. are being held there.  Messages of articles are displayed in the
  1168. Article buffer which is usually popped up automatically when necessary.
  1169. Scrolling of the messages and most other commands on articles can be
  1170. done in the Subject buffer.
  1171.  
  1172. * Menu:
  1173.  
  1174. * Reading Articles::            How to read articles.
  1175. * Searching Articles::          Searching for articles.
  1176. * Referencing Articles::        Referencing parent articles.
  1177. * Saving Articles::             Saving articles in your favorite format.
  1178. * Sorting Headers::             Sorting subjects and other headers.
  1179. * Followup and Reply::          Followup and reply commands.
  1180. * Exiting Newsgroup::           How to exit the current newsgroup.
  1181. * Other Subject Commands::      Other miscellaneous commands.
  1182.  
  1183. 
  1184. File: gnus.info,  Node: Reading Articles,  Next: Searching Articles,  Prev: Subject Commands,  Up: Subject Commands
  1185.  
  1186. Reading Articles
  1187. ================
  1188.  
  1189.    Commands for browsing headers and reading messages are described
  1190. here.
  1191.  
  1192. * Menu:
  1193.  
  1194. * Browsing Headers::            Browsing through headers.
  1195. * Moving Among Articles::       Selecting articles.
  1196. * Scrolling::                   Browsing through a message.
  1197. * Marking Articles::            Marking articles as (un)read.
  1198.  
  1199. * Thread-based Reading::        Reading articles based on conversation threads.
  1200. * Digest Articles::             How to read digest articles.
  1201.  
  1202. 
  1203. File: gnus.info,  Node: Browsing Headers,  Next: Moving Among Articles,  Prev: Reading Articles,  Up: Reading Articles
  1204.  
  1205. Walking Around Headers
  1206. ----------------------
  1207.  
  1208. `C-n'
  1209.      Move point to the next header (`gnus-Subject-next-subject').
  1210.  
  1211. `C-p'
  1212.      Move point to the previous header (`gnus-Subject-prev-subject').
  1213.  
  1214. `M-n'
  1215.      Move point to the next header, skipping marked articles
  1216.      (`gnus-Subject-next-unread-subject').
  1217.  
  1218. `M-p'
  1219.      Move point to the previous header, skipping marked articles
  1220.      (`gnus-Subject-prev-unread-subject').
  1221.  
  1222. `j NUMBER RET'
  1223.      Move point to the header specified by the article NUMBER
  1224.      (`gnus-Subject-goto-subject').
  1225.  
  1226. `/'
  1227.      Do an incremental search on headers (`isearch-forward').
  1228.  
  1229.    These commands are for moving the point on headers.  Type `SPC'
  1230. (`gnus-Subject-next-page') or `g' (`gnus-Subject-show-article') to read
  1231. an article on the line (*note Scrolling::.).
  1232.  
  1233. `='
  1234.      Expand the Subject Mode window to show the headers full window
  1235.      (`gnus-Subject-expand-window').
  1236.  
  1237. `C-t'
  1238.      Toggle truncation of the Subject buffer
  1239.      (`gnus-Subject-toggle-truncation').
  1240.  
  1241.    The command `=' (`gnus-Subject-expand-window') expands the Subject
  1242. Mode window by deleting the Article Mode window.  It is very useful for
  1243. displaying the Subject buffer full window when browsing through many
  1244. headers.  The command behaves different from the command `C-x 1'
  1245. (`delete-other-windows') if windows more than two are displayed.
  1246.  
  1247.    Long lines in the Subject buffer are truncated and the continuation
  1248. lines are not displayed normally.  The command `C-t'
  1249. (`gnus-Subject-toggle-truncation') toggles the truncation of the lines
  1250. in the buffer.
  1251.  
  1252.